ugp.org.SerialX

Class Serializer

java.lang.Object

ugp.org.SerialX.Serializer

public class Serializer
extends java.lang.Object

Serializer is powerful utility class that allows you to serialize any object in Java using protocol system. This system is generating code similar to JSON called SerialX but unlike for JSON is based on determinate order of arguments. Also works with regular serialization.

Since:

1.0.0

Author:

PETO

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Serializer.ProtocolRegistry ProtocolRegistry, place to register protocols!

Field Summary

Fields

Modifier and Type	Field and Description
static Serializer.ProtocolRegistry	PROTOCOL_REGISTRY This is serialization protocol registry.
static boolean	useProtocolIfCan Set this on true to force program to use SerializationProtocol also on java.io.Serializable objects.

Constructor Summary

Constructors

Constructor and Description
Serializer()

Method Summary

Modifier and Type	Method and Description
static java.util.List<java.lang.Object>	LoadFrom(java.io.File f)
static java.util.List<java.lang.Object>	LoadFromString(java.lang.String str)
static java.lang.String	SerializeClassic(java.io.Serializable obj)
static void	SerializeTo(java.io.File f, java.lang.Object... objs)
static java.lang.String	SerializeToString(java.lang.Object... obj)
static java.lang.String[]	splitValues(java.lang.String s) This function supposed to not be called by user.
static java.lang.Object	UnserializeClassis(java.lang.String objStr)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

PROTOCOL_REGISTRY

public static final Serializer.ProtocolRegistry PROTOCOL_REGISTRY

This is serialization protocol registry. Do not add there two protocols applicable for exactly same classes! Also I recommend to register protocols in generic order of object that are they applicable for! In other words If some object Foo has child classes, protocol of these classes should be registered after each other. Defaultly there is protocol for serializing java.util.List and java.lang.String!

Since:

1.0.0

useProtocolIfCan

public static boolean useProtocolIfCan

Set this on true to force program to use SerializationProtocol also on java.io.Serializable objects. Doing this also might take less memory space then using classic java.io.Serializable. In some cases, java Serialization can be more effective than protocols sometimes not! You should try which gives you the best result, then you can also deactivate protocols that are less effective than Java serialization. For example for long strings is classic Java serialization better than protocol is.

Since:

1.0.0

Constructor Detail

Serializer

public Serializer()

Method Detail

SerializeTo

public static void SerializeTo(java.io.File f,
                               java.lang.Object... objs)

Parameters:

f - | File to write in. This must be a text file.

objs - | Objects t serialize using SerialX.

Since:

1.0.0

SerializeToString

public static java.lang.String SerializeToString(java.lang.Object... obj)

Parameters:

objs - | Objects t serialize using SerialX.

Returns:

String with objects in SerialX code.

Since:

1.0.0

SerializeClassic

public static java.lang.String SerializeClassic(java.io.Serializable obj)
                                         throws java.io.IOException

Parameters:

obj - | Object to serialize using classic Java serialization.

Returns:

String with serialized object.

Throws:

java.io.IOException - - if an I/O error occurs while writing stream header

Since:

1.0.0

See Also:

java.lang.Base64

LoadFrom

public static java.util.List<java.lang.Object> LoadFrom(java.io.File f)

Parameters:

f - | Text file with serialized objects using SerialX.

Returns:

Unserialized objects or empty ArrayList if file is empty.

Since:

1.0.0

LoadFromString

public static java.util.List<java.lang.Object> LoadFromString(java.lang.String str)

Parameters:

str - | SerialX string with serialized objects.

Returns:

Unserialized objects or empty ArrayList if string is empty.

Since:

1.0.0

UnserializeClassis

public static java.lang.Object UnserializeClassis(java.lang.String objStr)
                                           throws java.io.IOException,
                                                  java.lang.ClassNotFoundException

Parameters:

objStr - | String to unserialize by classic Java serialization.

Returns:

Unsrialized object.

Throws:

java.io.IOException - - if an I/O error occurs while reading stream header

java.lang.ClassNotFoundException - - Class of a serialized object cannot be found.

Since:

1.0.0

See Also:

Base64

splitValues

public static java.lang.String[] splitValues(java.lang.String s)

This function supposed to not be called by user.

Parameters:

s - | String to split and check some syntax.

Returns:

Spited string.

Since:

1.0.0